home *** CD-ROM | disk | FTP | other *** search
/ Libris Britannia 4 / science library(b).zip / science library(b) / COMMUNIC / COMMUTIL / 2258.ZIP / EZLAST35.ZIP / EAZLAST3.DOC < prev    next >
Text File  |  1990-04-20  |  10KB  |  229 lines
  1.  
  2.                                EAZLAST3.EXE V3.56
  3.                                ------------------
  4.        Creates a file containing last caller's name and time for Host use
  5.        ------------------------------------------------------------------
  6.  
  7.                       For use with EaziLink V3 or EaziHost
  8.  
  9.      19th April 1990
  10.  
  11.      Disclaimer
  12.      ----------
  13.  
  14.      This program is being put  into  the  Public  Domain and may be freely
  15.      distributed  on  the  understanding  that  no  responsibility  can  be
  16.      accepted for any problems arising  from  its  use.  To the best of our
  17.      knowledge, it is 'Bug free' and serves its intended purpose.
  18.  
  19.      No charge, other than a  nominal  charge  for duplication and postage,
  20.      may be made for it and it should only be supplied as a single ARC, ZIP
  21.      or  PAK  file  called   EAZLAST3.ARC,  EAZLAST3.ZIP  or  EAZLAST3.PAK,
  22.      containing the EAZLAST3.EXE and EAZLAST3.DOC files.
  23.  
  24.  
  25.      Overview
  26.      --------
  27.  
  28.      EazLast3 is for use with EaziLink V3  Host mode or EaziHost V1 and was
  29.      created so that the name of the  last caller can be displayed whenever
  30.      a new caller logs on. The  program  does  this by reading the HOST.LOG
  31.      file (created  and  updated  automatically  by  Eazilink/EaziHost,  if
  32.      configured to do so) and finding details of the last caller.
  33.  
  34.      The name of  the  last  caller,  time  of  the  call  and, optionally,
  35.      duration and total number of callers to  the BB, are then written to a
  36.      file  called  'LASTCALL.TXT'.   This   file   may   be   displayed  by
  37.      EazIlink/Host in a number of ways, as described below.
  38.  
  39.      Using EAZLAST3
  40.      --------------
  41.  
  42.      EazLast3 must either be placed in  a directory specified with the PATH
  43.      command, or the full path to  EAZLAST3.EXE  must be specified when the
  44.      command is used.
  45.  
  46.      Optionally, a special configuration  file,  called EAZLAST3.CNF may be
  47.      used to provide  custom  text.  See  'Configuration  File'  below, for
  48.      details.
  49.  
  50.      The syntax for EazLast3 is:-
  51.  
  52.           EAZLAST3  <eazilinkmaindir> <outfiledir> (/N) (/T)
  53.  
  54.      <eazilinkmaindir> is the name of the EaziLink Main directory, in which
  55.                    HOST.LOG should be found.
  56.  
  57.      <outfiledir>  is  the  name   of   the   directory   into   which  the
  58.                    'LASTCALL.TXT' file is to be written.
  59.  
  60.      /N            is optional and will cause the  duration of the call NOT
  61.                    to be included if the default messages are being used.
  62.  
  63.                    Note: If a custom  message  is provided in EAZLAST3.CNF,
  64.                    this option is ignored and only those variables included
  65.                    in the CNF file will be included.
  66.  
  67.      /T            is optional and will result in  the number of callers in
  68.                    HOST.LOG being totalled. This option should only be used
  69.                    once, to obtain  a  starting  figure  for  the number of
  70.                    callers   if   this   feature   is   being   used.   See
  71.                    'Configuration file' below.
  72.  
  73.      NOTE: /T and /N may NOT be used at the same time.
  74.  
  75.      Example:
  76.  
  77.           EAZLAST3 \EAZILINK\  \EAZILINK\HOSTMAIN
  78.  
  79.      Note that if the trailing backslash is  omitted from the end of either
  80.      directory name, EazLast3 will add it.
  81.  
  82.      The above  command  should  be  used  in  the  RECYCLE.BAT  file which
  83.      EaziLink automatically runs if the file exists.
  84.  
  85.      LASTCALL.TXT can be appended to the end  of the LOGO.HST file, so that
  86.      the details of the previous caller  are  displayed even before the new
  87.      caller logs on, or, alternatively,  may  be  renamed to NOTICE.HST, or
  88.      appended to an existing NOTICE.HST file.  An  example of this would be
  89.      where you wish to display the name of the last caller and a 'Quote for
  90.      the day', generated by a program such as QUOTER.
  91.  
  92.      Note: The HOST.LOG generation option  in EaziLink's Host Configuration
  93.      (or EaziHost Configuration) MUST be  set  to  ON  if EazLast3 is to be
  94.      used.
  95.  
  96.      Examples of entries in RECYCLE.BAT
  97.      ----------------------------------
  98.  
  99.      Example 2 is the best solution in most cases.
  100.  
  101.      1. A simple example.
  102.  
  103.          ECHO OFF
  104.          \EAZILINK\\EAZLAST3 \EAZILINK\ \EAZILINK\HOSTMAIN
  105.          COPY \EAZILINK\HOSTMAIN\LASTCALL.TXT \EAZILINK\HOSTMAIN\NOTICE.HST
  106.  
  107.      This will copy the LASTCALL.TXT  file  to  a file called NOTICE.HST in
  108.      \EAZILINK\HOSTMAIN directory.  Note  that  the  full  pathname  of the
  109.      command is used to ensure that the program file is found.
  110.  
  111.      2. An example appending to LOGO.HST
  112.  
  113.          ECHO OFF
  114.          EAZLAST3 \EAZIHOST\ \EAZIHOST\HOSTMAIN\
  115.          COPY \EAZIHOST\HOSTMAIN\LOGO.HLD+\EAZIHOST\HOSTMAIN\LASTCALL.TXT
  116.                                                        \EAZIHOST\LOGO.HST
  117.  
  118.      (Note The last two lines should all  be on the same line, separated by
  119.      a space)
  120.  
  121.      Note that in this case, the  standard  LOGO.HST file should be renamed
  122.      to LOGO.HLD before EazLast3  is  used  for  the  first  time. The COPY
  123.      command copies and appends the  two  files, LOGO.HLD and LASTCALL.TXT,
  124.      to a file called  LOGO.HST.   This  happens  every time RECYCLE.BAT is
  125.      run, otherwise the last caller's name would  be appended to the end of
  126.      previous caller each time.
  127.  
  128.  
  129.      Configuration File - EAZLAST3.CNF
  130.      ---------------------------------
  131.  
  132.      A configuration file may be used.  It  is  not vital, but if provided,
  133.      may serve two purposes.
  134.  
  135.      1. Allows the text which is to be displayed to be specified instead of
  136.      the default message provided by the program.
  137.  
  138.      2. Keeps a record of the  total  number  of callers. This is optional,
  139.      but, if present, is updated by EazLast3 after each new caller.
  140.  
  141.      Important:- The configuration  file  must  be  called EAZLAST3.CNF and
  142.      must be located in the <outfiledir>  described  above. If this file is
  143.      found by EazLast3, then the contents  will be read and used, otherwise
  144.      the default layout provided by EazLast3 will be used.
  145.  
  146.      EAZLAST3.CNF may be created with any text  editor  and may be up to 10
  147.      lines long, although generally two  or  three  lines will be more than
  148.      enough. EaziLink pseudo ANSI codes may be included in the CNF file.
  149.  
  150.      Note: If EaziLink  pseudo  codes  are  to  be  included, the resulting
  151.      LASTCALL.TXT file must not  be  displayed  before  the  user has given
  152.      their name and password. This includes  the LOGO.HST file displayed at
  153.      the very start of a call.
  154.  
  155.      Five special variables may be included in  the file and, if found, the
  156.      values they contain will be substituted.  Any  or all of the variables
  157.      may be omitted, or used more than once. The five variables are :-
  158.  
  159.          %first     - The first name of the previous caller
  160.          %last      - The last name of the previous caller
  161.          %time      - The time they logged on
  162.          %duration  - The length of time they were on line, in minutes.
  163.          %callernum - The number of calls made to the BB. Used in
  164.                       conjunction with 'NC:'. See below.
  165.  
  166.      The supplied EAZLAST3.CNF file is  included  as  an example of its use
  167.      and may  be  omitted  if  not  required,  or  modified  to  suit  your
  168.      requirements.
  169.  
  170.      If the last line of the  EAZLAST3.CNF file starts with 'NC:', followed
  171.      by a number in the range  0-65535,  EazLast3 will read this number and
  172.      increment it by one after  every  new  caller. Normally, this would be
  173.      set to zero when a new BB is set  up. If this line is not present, the
  174.      number of callers will not be included in the file.
  175.  
  176.      NOTE: if the '%callernum' feature is  being used, the 'NC:' entry MUST
  177.      be the the last line of the EAZLAST3.CNF file.
  178.  
  179.      Note: EazLast3 will also add the name  of the last caller and the time
  180.      they called to the 'NC:' line.  This is used for verification purposes
  181.      and to stop the counter being updated when local log-ins are made.
  182.  
  183.      If you want to obtain an  initial  total  of previous callers from the
  184.      HOST.LOG file, use EazLast3 with  the  /T  option,  to obtain a total.
  185.      EazLast3 will write the result to the EAZFILE3.CNF file automatically.
  186.  
  187.  
  188.      History
  189.      -------
  190.  
  191.      3.00  10/11/89 - Beta release
  192.      3.01  11/11/89 - First release.
  193.                     - added optional command line  switch  (/N) to turn off
  194.                       display of 'time online', if not required by SysOp.
  195.                     - Date of last caller  is  no  longer included, as this
  196.                       could be incorrect in certain circumstances.
  197.                     - Bug fix to documentation!
  198.      3.02  21/11/89 - Fixed bug which caused a  hang up with HOST.LOG files
  199.                       smaller than 2K.
  200.                     - provided optional  facility  to  use  a configuration
  201.                       file to specify the text and details to be displayed.
  202.      3.53  28/12/89 - Works with either EaziLink Host mode, or EaziHost.
  203.                     - Removed surplus line  feed  at  end  of  output file,
  204.                       which caused an excessive gap at end when displayed.
  205.      3.54  05/02/90 - Included the (optional)  facility  to  show the total
  206.                       number of callers to the  BB.  Provision also made to
  207.                       obtain a starting number from HOST.LOG.
  208.      3.55  04/04/90 - Minor  changes,  largely  as   a  result  of  library
  209.                       changes.
  210.      3.56  19/04/90 - Changed  procedure  for  displaying   the  number  of
  211.                       callers, to make it more  flexible.  The text may now
  212.                       be specified  in  the  CNF  file  as  a  variable.  A
  213.                       resultant change is  that  instead  of  the number of
  214.                       lines in the  CNF  file  being  unlimited,  it is now
  215.                       restricted to 10 lines maximum,  which should be more
  216.                       than enough.
  217.  
  218.  
  219.      David Foster
  220.      H.L.C. Services
  221.      High Leys
  222.      Crook
  223.      Kendal
  224.      Cumbria
  225.      LA8 8LF
  226.  
  227.                                                END
  228.  
  229.